home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / python / itrsgi.lha / Itr.help < prev    next >
Text File  |  1993-06-19  |  4KB  |  108 lines
  1. *** Internet Talk Radio browser
  2.  
  3. This browser gives access to the Internet Talk Radio files stored at a
  4. nearby ftp site.  Internet Talk Radio is produced by Carl Malamud; use
  5. the browser to display the text file "ITRintro.readme" (and other
  6. readme files) to find out more about it.
  7.  
  8. While in principle you can listen to the ITR files by ftp'ing them to
  9. your local machine and then using a program like "sfplay", this is:
  10.  
  11.     - complicated: you need to use the ftp client program;
  12.  
  13.     - tedious: these files are HUGE, so even over ethernet, the ftp
  14.       transfer takes a long time, and you may run out of disk space
  15.       when transferring several files;
  16.  
  17.     - clumsy: there is no way to restart sfplay in the middle of a
  18.       file or to make it skip uninteresting parts.
  19.  
  20. The ITR browser solves all these problems: it contains a simple
  21. point-and-click interface to select files for automatic transfer via
  22. ftp, overlaps the ftp transfer with playing, and provides a player
  23. interface modelled after CD players familiar to everyone.  At all
  24. times, the user is in control and can cancel an ongoing ftp transfer.
  25.  
  26.  
  27. *** The user interface
  28.  
  29. The main window is divided in three areas, from top to bottom: audio
  30. player controls (a row of buttons and a scroller); ftp transfer status
  31. display (some text labels, a thermometer scale and a cancel button);
  32. and directory contents (a scrollable list of file names).  Optionally,
  33. a separate text window can be shown.
  34.  
  35.  
  36. *** The list of files
  37.  
  38. The files are sorted alphabetically.  Each line contains a file name,
  39. its size between parentheses, and the date it was last modified.
  40.  
  41. The Internet Talk Radio filenames, e.g. "050293_geek_01_ITR.au",
  42. should be parsed as follows:
  43.  
  44.     050293: date when the file was recorded (mmhhyy)
  45.     _geek: this is a program in the series "Geek of the Week"
  46.     _01: this is part 01 of this particular program
  47.     _ITR: Internet Talk Radio identifier
  48.     .au: this is an audio file (text files have a .readme extension)
  49.  
  50. If you double click on a line in the list, the file is either
  51. displayed in a separate window (if it is a text file) or played (if it
  52. is an audio file).  Double clicking on directories and the like
  53. doesn't do anything useful.
  54.  
  55.  
  56. *** The ftp transfer status display
  57.  
  58. Before a file can be (dis)played, it must be transferred via ftp to
  59. the local machine to a temporary file.  The progress of this transfer
  60. can be seen by the thermometer scale.  If a transfer is slow, you can
  61. choose to cancel it by clicking the cancel button above it.
  62.  
  63. When retrieving a text file, the file is not displayed until the
  64. transfer is complete; when retrieving an audio file, the player is
  65. started as soon as the first buffer of data has been received.
  66.  
  67.  
  68. *** The player controls
  69.  
  70. The play, pause and stop buttons work like the buttons on the average
  71. CD player.  The pause button toggles between playing and pausing
  72. state.  The stop button resets the play position to the beginning of
  73. the file.  The play button continues playing at the current position;
  74. if the current position is at the end, it restarts from the beginning
  75. (when playing reaches the end normally, the player stops but does not
  76. reset its position).  Exactly one of the play, pause and stop buttons
  77. is highlighted to indicating the current player status.
  78.  
  79. The time display button displays the elapsed time (+mm:ss) or
  80. remaining time (-mm:ss).  Clicking on it toggles between its two
  81. display modes.
  82.  
  83. The quit button exits from the application.
  84.  
  85. The help button pops up a text window containing this help text.
  86.  
  87. The slider shows the current playing position in an analog fashio, and
  88. allows fast forward/reverse and random access.  Clicking in the arrows
  89. activates fast forward/reverse motion as long as you hold the mouse
  90. button depressed.  Clicking in the galley activates faster
  91. forward/reverse motion.  Dragging the slider forces the position to a
  92. particular position.
  93.  
  94. NOTA BENE: when the ftp transfer is still in progress, the player
  95. automatically switches to pause mode when it reaches part of the file
  96. that has not yet been transferred.  Click the play button to restart
  97. playing.
  98.  
  99.  
  100. *** The text window
  101.  
  102. This contains a scrollable area showing the contents of the last text
  103. file retrieved (or this help text), and above it a single close
  104. button.  Use the scroll bars to scroll around in the text.  Clicking
  105. in the close button removes the window.  The window is freely
  106. resizable and moveable, independent from the main user interface
  107. window.
  108.